home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / os2 / pmics211.zip / manual.doc < prev    next >
Text File  |  1996-09-15  |  37KB  |  813 lines
  1. PMICS - The Internet Chess Client for OS/2 Warp
  2. Version 2.1.1      Released 15th September 1996
  3. Copyright (C)1996 Paul Mitchell/Mystic Software
  4.  
  5. USER MANUAL
  6. ------------------------------------------------------------------------------
  7.  
  8. See Also
  9. --------
  10. README        for final notes and information about this release
  11. HISTORY.DOC   for revision history
  12.  
  13.  
  14. Introduction
  15. ------------
  16. PMICS is a sophisticated interface for the numerous chess servers available on
  17. the internet. Using PMICS you can play chess, observe other games and chat to
  18. the inhabitants of these servers. PMICS is a native, 32-bit, multi-threaded
  19. application which makes full use of the incredible power of OS/2 Warp.
  20.  
  21. This file is a concise guide to using PMICS. It is a stopgap measure until
  22. the next release which will have a full on-line help capability. Please tell
  23. the author of any corrections or omissions.
  24.  
  25. For news, information and updates be sure to check out the web site dedicated
  26. to PMICS. The URL is http://www.tcom.co.uk/secondnature/pmics/
  27.  
  28.  
  29. System Requirements
  30. -------------------
  31. To run PMICS successfully, your system must have at least the following
  32. configuration...
  33.  
  34. o OS/2 Warp Version 3.0 or above (including Warp Connect and Merlin)
  35. o A TCP/IP connection to the internet, such as Internet Access Kit found
  36.   on the Warp BonusPak, or the TCP/IP support in Warp Connect
  37. o A mouse
  38. o A SuperVGA display with 256 or more colours
  39.  
  40.  
  41. Installation
  42. ------------
  43. Create a folder on your system and copy the file "pmics.exe" into it. You can
  44. then create a program object for PMICS in the usual fashion.
  45.  
  46.  
  47. Running PMICS
  48. -------------
  49. PMICS is normally run from a program object. You do not need to specify any
  50. command line parameters for normal use.
  51.  
  52. If you wish to automatically connect to a server when running PMICS, specify
  53. the tag name used to create the server in the configuration as the parameters
  54. in the program object. Using this feature, you can create multiple program
  55. objects each connecting to a different server.
  56.  
  57.  
  58. Quick Start
  59. -----------
  60. When you run PMICS, the main window appears. This consists of a main area
  61. with a scrollbar which displays text from a server. Above this is the main
  62. control toolbar. At the bottom of the window is the communication control
  63. area which contains two buttons and a command line.
  64.  
  65. You may run PMICS without an active internet connection, but your system
  66. should be connected to the internet before attempting to connect to a
  67. server. PMICS will not establish an internet link for you.
  68.  
  69. To connect to a server, click the "Login" button on the main toolbar. You
  70. will see a list of available servers appear. Select the server you wish to
  71. connect with and press the OK button.
  72.  
  73. You should see some messages appear in the text area. Normally you will see
  74. "Establishing connection with <server>" followed by "Connection established"
  75. and finally the welcome screen from the server.
  76.  
  77. PMICS should automatically log you in to the server. You are now ready to
  78. play, observe and chat!
  79.  
  80.  
  81. Observing Games
  82. ---------------
  83. You can easily observe other people's games using PMICS. First, locate the
  84. game (or games) you wish to observe. The player information window is
  85. useful for this since you can click on an active game then click the
  86. Observe button. You can also observe using server commands. Click the
  87. Games button on the main toolbar to list all the active games. Locate the
  88. game you are interested in, type 'obs <game number>' on the command line
  89. then press Enter.
  90.  
  91. If all went well, the game board will appear on the screen. See the section
  92. on game windows below for more information.
  93.  
  94.  
  95. Playing Games
  96. -------------
  97. Playing chess is equally simple with PMICS. There are two ways to do this -
  98. you can challenge another player, or accept a challenge from someone. You
  99. will only be able to receive challenges from others if you are 'open'. The
  100. Open button on the main toolbar will change your open status.
  101.  
  102. When someone challenges you to a match, a dialog will appear (with an
  103. appropriate sound if you have set this up). You can review the game
  104. parameters (time controls, game type) in this dialog then choose to accept,
  105. decline or ignore the challenge. If you accept, a game window will appear.
  106.  
  107. To challenge someone else to a match, you must first locate your "victim".
  108. Again, the player information window is useful here. Click on a player who
  109. is not currently involved in a game then click the Finger button. This will
  110. display information about that person including ratings and personal notes.
  111. When you have decided whom you would like to challenge, select that player
  112. then click the Challenge button. A dialog will appear allowing you to set
  113. the game parameters. Click the Issue button to send the challenge. If your
  114. chosen opponent accepts, the game window will appear.
  115.  
  116. See the section on game windows below for more information.
  117.  
  118.  
  119. Talking
  120. -------
  121. Chess servers are like clubs. You can sit back and listen to people talking,
  122. hold private conversations and make a complete nuisance of yourself (which
  123. is not recommended). There are several server commands which allow you to
  124. talk, depending on who and how many players you wish to address. PMICS also
  125. has a sophisticated windowing system which allows you to separate different
  126. kinds of chat into their own custom windows.
  127.  
  128. The main server commands for talking are listed below. Although it is better to
  129. use the PMICS talk windows, these can be typed on the command line to send
  130. one-off messages.
  131.  
  132. 'tell <user> <message>'
  133.    This sends a message to the named user. It will appear on their screen as
  134.    '<your name> tells you: <message>'. This type of conversation is private
  135.    and the user you address must be logged into the server.
  136.    
  137. 'tell <channel number> <message>'
  138.    The servers have channels, much like CB radio, dedicated to specific
  139.    topics. This form of tell sends a message to all users who are listening
  140.    to the channel. It will appear on their screens as
  141.    '<your name>(<number>): <message>'. A help file on the server called
  142.    'channel_list' contains the topics for each channel. If you require help
  143.    regarding the server, this is generally the topic of channel 1.
  144.    
  145. 'shout <message>'
  146.    This command sends a message to all users who are listening to shouts. It
  147.    appears on their screen as '<your name> shouts: <message>'. Most servers
  148.    limit the number of shouts you can send in a specific time period.
  149.    
  150. 'it <message>'
  151.    This is a derivative of the shout command. The difference is that your
  152.    message appears in the form '--> <your name> <message>'.
  153.    
  154. 'cshout <message>'
  155.    Another derivative of shout, this should be used only for topics related
  156.    to chess.
  157.    
  158. 'kib <message>'
  159.    Kibitz. If you are observing or playing a game, this command will send a
  160.    message to all the observers of the game *and* the players. This can be
  161.    very distracting to the players, so only use it if you are sure you are
  162.    allowed. If it's your own game, do as you wish.
  163.    
  164. 'whisper <message>'
  165.    This is similar to kibitzing except that the message goes only to the
  166.    observers and not to the players.
  167.  
  168.  
  169. A General Note About PMICS Windows
  170. ----------------------------------
  171. All the main windows in PMICS - including player information, game and talk
  172. windows - exhibit the same general characteristics. Their size and position
  173. is stored. You can change colours and fonts by dragging from the OS/2 colour
  174. and font palettes. In the main and talk windows, the displayed text will
  175. automatically wrap to the width of the window.
  176.  
  177. Experiment with them! Set the colours, fonts and positions just the way you
  178. like them. PMICS will remember.
  179.  
  180.  
  181. The Main Window
  182. ---------------
  183. The main PMICS window is where you control server activities, and where all
  184. server output is displayed (if not handled by a talk window - see later). It
  185. is the only window from which you should send server commands.
  186.  
  187. The main toolbar is the primary means of controlling PMICS. The buttons which
  188. appear depend on whether you are connected